feat(tanstackstart-react): Add sentryTanstackStart Vite plugin for Source Map Uploads #18712

nicohrubec · 2026-01-07T13:20:18Z

Adds sentryTanstackStart Vite plugin to enable automatic source map uploads in TanStack Start applications.

What it does
I tried to align with what we do in other SDKs (e.g. SvelteKit). On a high-level it:

Uploads source maps to Sentry using @sentry/vite-plugin if configured, passing through all options set by the user (including release, sourcemaps, headers, etc.)
If the source maps option is not defined and also the files to delete option is not defined, we enable cleaning up all .map files after the source map upload
If the source map configuration is undefined, we additionally enable hidden source map generation

Usage

// vite.config.ts
  import { defineConfig } from 'vite';
  import { sentryTanstackStart } from '@sentry/tanstackstart-react';
  import { tanstackStart } from '@tanstack/react-start/plugin/vite';

  export default defineConfig({
    plugins: [
      sentryTanstackStart({
        org: 'my-org',
        project: 'my-project',
        // authToken via SENTRY_AUTH_TOKEN env var
      }),
      tanstackStart(),
    ],
  });

Tests

Added unit tests for sourceMaps.ts and sentryTanstackStart.ts covering plugin composition, options passing, and source map settings logic
Updated the E2E test to use the new plugin pattern

Closes #18664

github-actions · 2026-01-07T13:39:41Z

node-overhead report 🧳

Note: This is a synthetic benchmark with a minimal express app and does not necessarily reflect the real-world performance impact in an application.

Scenario	Requests/s	% of Baseline	Prev. Requests/s	Change %
GET Baseline	8,984	-	9,365	-4%
GET With Sentry	1,714	19%	1,732	-1%
GET With Sentry (error only)	6,027	67%	6,087	-1%
POST Baseline	1,166	-	1,172	-1%
POST With Sentry	585	50%	592	-1%
POST With Sentry (error only)	1,022	88%	1,059	-3%
MYSQL Baseline	3,274	-	3,300	-1%
MYSQL With Sentry	441	13%	493	-11%
MYSQL With Sentry (error only)	2,668	81%	2,710	-2%

View base workflow run

s1gr1d · 2026-01-09T13:59:09Z

packages/tanstackstart-react/src/config/types.ts

+/**
+ * Build options for the Sentry plugin. These options are used during build-time by the Sentry SDK.
+ */
+export type SentryTanstackStartReactPluginOptions = {


You can/should extend from this type, so we can make sure that all build-time options are aligned:

sentry-javascript/packages/core/src/build-time-plugins/buildTimeOptionsBase.ts

Line 27 in 2c6e710

export interface BuildTimeOptionsBase {

ah nice thanks I did not know that existed, updated

s1gr1d · 2026-01-09T14:03:39Z

packages/tanstackstart-react/src/vite/addSentryPlugins.ts

+  if (process.env.NODE_ENV !== 'development') {
+    // Check if source maps upload is enabled
+    // Default to enabled
+    const sourceMapsEnabled = options.sourceMapsUploadOptions?.enabled ?? true;


You probably want to use options.sourcemaps.disable here. Also make sure people can still create a release, even if they don't want to upload source maps.

updated to use disable

also always adding the sentry vite plugin down passing down the source maps disable option so that release creation works also if people do not use source maps

s1gr1d · 2026-01-12T10:42:24Z

A general thought I had on this: Are the sources included in Nitro source maps? In the Nuxt SDK, we have to disable this setting:

sentry-javascript/packages/nuxt/src/vite/sourceMaps.ts

Line 361 in cc93c68

nitroConfig.rollupConfig.output.sourcemapExcludeSources = false;

Lms24

Naive question for now: What's the advantage over this wrapper that we can't achieve with just exporting a plugin? If we need to modify the vite config, Vite offers plugin hooks to do so from within a plugin.

I'd personally prefer the plugin approach because this is a pattern that users are more used to than wrapping their config. If you or anyone else has different opinions, let's hear it :D

packages/tanstackstart-react/src/vite/sourceMaps.ts

packages/tanstackstart-react/src/vite/addSentryPlugins.ts

packages/tanstackstart-react/src/vite/sourceMaps.ts

packages/tanstackstart-react/src/vite/sentryTanstackStart.ts

packages/tanstackstart-react/src/vite/sourceMaps.ts

nicohrubec · 2026-01-14T10:36:38Z

@Lms24 good call, changed the approach from a wrapper to a simple plugin that users can add

nicohrubec · 2026-01-14T11:15:20Z

@s1gr1d judging from here and here that option seems to default to false in the vite rollup build options, so seems fine I think?

packages/tanstackstart-react/src/vite/sourceMaps.ts

This reverts commit 286f624.

packages/tanstackstart-react/src/vite/sourceMaps.ts

Lms24 · 2026-01-15T18:29:38Z

packages/tanstackstart-react/test/vite/sentryTanstackStart.test.ts

+      sourcemaps: { disable: true },
+    });
+
+    expect(plugins).toHaveLength(2);


super-l: we can use expect(plugins).toEqual([..., ..., ...]) here (+ in the tests below) instead of the length and find operations. I would argue the plugin order should be deterministic and we should fail the test if the order changes. Sometimes even plugins depend on each other, so the order matters.

Lms24 · 2026-01-16T11:32:38Z

dev-packages/e2e-tests/test-applications/tanstackstart-react/vite.config.ts

    port: 3000,
  },
  plugins: [
+    sentryTanstackStart({


Nice, I think this is great UX, thanks for changing the approach!

Lms24 · 2026-01-16T11:37:35Z

packages/tanstackstart-react/src/vite/sourceMaps.ts

+
+  // Default to auto-deleting source maps from hidden directories after upload
+  // Users can override this by explicitly setting sourcemaps.filesToDeleteAfterUpload
+  const defaultFilesToDelete = ['.*/**/*.map'];


just to confirm: TSS' build output is in a hidden directory? (as opposed to something like /dist)?

Lms24 · 2026-01-16T11:40:38Z

packages/tanstackstart-react/src/vite/sentryTanstackStart.ts

+  const plugins: Plugin[] = [];
+
+  // Only add plugins in production builds
+  if (process.env.NODE_ENV !== 'development') {


super-l: If we don't do anything in development, we could invert the if condition here and early return. Feel free to ignore, this is mostly just me preferring early returns and keeping the mainline logic outside of conditions 😅

Lms24 · 2026-01-16T11:43:15Z

packages/tanstackstart-react/src/vite/sourceMaps.ts

+  const configPlugin: Plugin = {
+    name: 'sentry-tanstackstart-source-maps-config',
+    apply: 'build',
+    enforce: 'pre',


m: we probably want to enforce that configPlugin plugin runs 'post' so that we get the most likely final config object

actually now that I think about it, does this plugin do anything besides logging? Looks like we unconditionally set filesToDeleteAfterUpload when we create the @sentry/vite-plugin plugins (?)

nicohrubec added 2 commits January 7, 2026 14:19

Add placeholder vite config wrapper

704a781

align usage with solidstart

6cc5784

nicohrubec added 6 commits January 7, 2026 14:57

Add placeholder to add plugins

b4a0d83

Add sentry vite plugin and enable source maps plugins automatically

b6ddbff

?

8c6f0fa

add unit tests

207a96a

add vite wrapper to e2e tests

53e9099

simplify unit tests

b9c51e9

nicohrubec changed the title ~~feat(tanstackstart-react): Add vite config wrapper~~ feat(tanstackstart-react): Add Vite Config Wrapper for Source Map Uploads Jan 8, 2026

nicohrubec marked this pull request as ready for review January 8, 2026 08:37

nicohrubec requested review from Lms24, andreiborza and s1gr1d January 8, 2026 08:37

s1gr1d reviewed Jan 9, 2026

View reviewed changes

Lms24 reviewed Jan 12, 2026

View reviewed changes

nicohrubec added 2 commits January 13, 2026 17:32

use buildTimeOptionsBase instead of defining my own type

6eb1c8b

Merge branch 'develop' into nh/tss-vite-config-wrapper

4dcdabf

sentry bot reviewed Jan 13, 2026

View reviewed changes

packages/tanstackstart-react/src/vite/sourceMaps.ts Outdated Show resolved Hide resolved

cursor bot reviewed Jan 13, 2026

View reviewed changes

packages/tanstackstart-react/src/vite/sourceMaps.ts Outdated Show resolved Hide resolved

packages/tanstackstart-react/src/vite/addSentryPlugins.ts Outdated Show resolved Hide resolved

packages/tanstackstart-react/src/vite/sourceMaps.ts Outdated Show resolved Hide resolved

.

9aaabd9

cursor bot reviewed Jan 13, 2026

View reviewed changes

packages/tanstackstart-react/src/vite/sourceMaps.ts Outdated Show resolved Hide resolved

nicohrubec added 2 commits January 14, 2026 10:35

switch to sentry vite plugin

bfa238a

add changelog entry and pass down all options

086b9f6

sentry bot reviewed Jan 14, 2026

View reviewed changes

packages/tanstackstart-react/src/vite/sourceMaps.ts Show resolved Hide resolved

sentry bot reviewed Jan 14, 2026

View reviewed changes

packages/tanstackstart-react/src/vite/sourceMaps.ts Show resolved Hide resolved

cursor bot reviewed Jan 14, 2026

View reviewed changes

packages/tanstackstart-react/src/vite/sentryTanstackStart.ts Outdated Show resolved Hide resolved

packages/tanstackstart-react/src/vite/sourceMaps.ts Show resolved Hide resolved

nicohrubec added 2 commits January 14, 2026 10:59

clean

05e08f1

always add sentry vite plugin and pass down disable option

bc0acdd

nicohrubec added 3 commits January 14, 2026 14:04

Merge branch 'develop' into nh/tss-vite-config-wrapper

8e60de8

readability

9bbd0b0

update tests

283a545

nicohrubec requested review from Lms24 and s1gr1d January 14, 2026 15:25

sentry bot reviewed Jan 14, 2026

View reviewed changes

packages/tanstackstart-react/src/vite/sourceMaps.ts Show resolved Hide resolved

Merge branch 'develop' into nh/tss-vite-config-wrapper

1e736b4

nicohrubec changed the title ~~feat(tanstackstart-react): Add Vite Config Wrapper for Source Map Uploads~~ feat(tanstackstart-react): Add sentryTanstackStart Vite plugin for Source Map Uploads Jan 14, 2026

sentry bot reviewed Jan 14, 2026

View reviewed changes

packages/tanstackstart-react/src/vite/sourceMaps.ts Show resolved Hide resolved

nicohrubec added 5 commits January 15, 2026 11:55

bump bundler plugins

841a311

update

9ad7a8d

update bundler plugins fr this time

286f624

Revert "update bundler plugins fr this time"

505c92c

This reverts commit 286f624.

Merge branch 'develop' into nh/tss-vite-config-wrapper

07d5e77

sentry bot reviewed Jan 15, 2026

View reviewed changes

packages/tanstackstart-react/src/vite/sourceMaps.ts Show resolved Hide resolved

nicohrubec added 2 commits January 16, 2026 08:17

Merge branch 'develop' into nh/tss-vite-config-wrapper

073e352

update sentry vite plugin

8ce5358

nicohrubec mentioned this pull request Jan 16, 2026

feat(tanstackstart-react): Auto-instrument global middleware #18844

Open

nicohrubec self-assigned this Jan 16, 2026

Lms24 reviewed Jan 16, 2026

View reviewed changes

Uh oh!

feat(tanstackstart-react): Add sentryTanstackStart Vite plugin for Source Map Uploads #18712

Are you sure you want to change the base?

feat(tanstackstart-react): Add sentryTanstackStart Vite plugin for Source Map Uploads #18712

Conversation

nicohrubec commented Jan 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

node-overhead report 🧳

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

s1gr1d commented Jan 12, 2026

Uh oh!

Lms24 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nicohrubec commented Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nicohrubec commented Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

nicohrubec commented Jan 7, 2026 •

edited

Loading

github-actions bot commented Jan 7, 2026 •

edited

Loading

nicohrubec commented Jan 14, 2026 •

edited

Loading

nicohrubec commented Jan 14, 2026 •

edited

Loading